出处：掘金

原作者：金泽宸

真正优秀的前端架构师，不仅要会“写代码”，还要会“写好团队的工具链与交付系统”

写在前面

架构师的职责不仅仅是写好业务代码，更重要的是提升整个团队的交付效率和质量保障能力

而工程化系统，就是团队交付体系的“发动机”：

• 如何构建极速、稳定？
• 如何自动化部署、版本标记？
• 如何引入 Lint、Test、打包分析、监控？

从实战出发，全面构建一个现代化前端工程体系

现代工程化系统架构图

graph TB
A[本地开发] --> B[Lint 检查]
B --> C[单元测试]
C --> D[构建打包]
D --> E[产物上传 OSS]
E --> F[CI/CD 发布]
F --> G[监控 & 告警]

构建系统优化（Vite + ESBuild）

推荐方案：

示例 vite.config.ts：

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import visualizer from 'rollup-plugin-visualizer'

export default defineConfig({
  plugins: [vue(), visualizer()],
  build: {
    outDir: 'dist',
    sourcemap: true,
  }
})

代码质量体系（Lint + Prettier + Husky）

配置 .eslintrc.js 示例：

module.exports = {
  extends: ['eslint:recommended', 'plugin:vue/vue3-recommended', 'prettier'],
  rules: {
    'vue/no-v-html': 'off',
    'no-console': 'warn'
  }
}

Prettier：

// .prettierrc
{
  "semi": false,
  "singleQuote": true,
  "printWidth": 100
}

Git Hooks 自动检查（husky + lint-staged）：

# 安装
pnpm add -D husky lint-staged
npx husky install
npx husky add .husky/pre-commit "npx lint-staged"

// package.json
"lint-staged": {
  "*.{js,ts,vue}": ["eslint --fix", "prettier --write"]
}

测试体系接入（Jest + Vue Test Utils）

// user.spec.ts
import { shallowMount } from '@vue/test-utils'
import User from '../User.vue'

describe('User.vue', () => {
  it('should render name prop', () => {
    const wrapper = shallowMount(User, {
      props: { name: 'Tom' }
    })
    expect(wrapper.text()).toContain('Tom')
  })
})

重点测试公共组件、核心逻辑、工具函数等

版本管理与构建产物发布

changesets 自动生成 changelog + 版本：

pnpm changeset
pnpm changeset version
pnpm changeset publish

结合 GitHub Action 可实现：

• 自动生成变更日志
• 自动打 Tag 发布版本
• 自动部署产物（OSS/CDN）

CI/CD 发布流程设计（GitHub Actions + Vercel）

GitHub Actions 示例 .github/workflows/deploy.yml：

name: Deploy

on:
  push:
    branches:
      - main

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: pnpm/action-setup@v2
        with:
          version: 8
      - run: pnpm install
      - run: pnpm build
      - run: aws s3 sync dist/ s3://your-bucket --delete

可根据环境（prod/stage/dev）进行构建参数控制

前端性能监控与告警（Sentry + Web-Vitals）

接入 Web Vitals：

import { getCLS, getFID, getLCP } from 'web-vitals'

getCLS(console.log)
getFID(console.log)
getLCP(console.log)

接入 Sentry：

Sentry.init({
  dsn: 'https://examplePublicKey@o0.ingest.sentry.io/0',
  integrations: [new Sentry.BrowserTracing()],
})

实时监控错误率、卡顿点、慢加载等问题

工程优化建议清单